---
title: xAI
description: Learn how to use xAI with Agno.
---

xAI is a platform for providing endpoints for Large Language models.
See their list of models [here](https://docs.x.ai/docs/models).

We recommend experimenting to find the best-suited model for your use-case. The `grok-3` model is good for most use-cases.

## Authentication

Set your `XAI_API_KEY` environment variable. You can get one [from xAI here](https://console.x.ai/).

<CodeGroup>

```bash Mac
export XAI_API_KEY=sk-***
```

```bash Windows
setx XAI_API_KEY sk-***
```

</CodeGroup>

## Example

Use `xAI` with your `Agent`:

<CodeGroup>

```python agent.py

from agno.agent import Agent
from agno.models.xai import xAI

agent = Agent(
    model=xAI(id="grok-3"),
    markdown=True
)

agent.print_response("Share a 2 sentence horror story.")
```

</CodeGroup>

## Live Search

xAI models support live search capabilities that can access real-time information:

<CodeGroup>

```python live_search.py
from agno.agent import Agent
from agno.models.xai import xAI

agent = Agent(
    model=xAI(
        id="grok-3",
        search_parameters={
            "mode": "on",
            "max_search_results": 20,
            "return_citations": True,
        },
    ),
    markdown=True,
)

agent.print_response("What's the latest news about AI developments?")
```

</CodeGroup>

<Note> View more examples [here](/examples/models/xai/basic). </Note>

## Params

| Parameter    | Type               | Default                        | Description                                                           |
| ------------ | ------------------ | ------------------------------ | --------------------------------------------------------------------- |
| `id`         | `str`              | `"grok-beta"`                  | The id of the xAI model to use                                       |
| `name`       | `str`              | `"xAI"`                        | The name of the model                                                 |
| `provider`   | `str`              | `"xAI"`                        | The provider of the model                                             |
| `api_key`    | `Optional[str]`    | `None`                         | The API key for xAI (defaults to XAI_API_KEY env var)                |
| `base_url`   | `str`              | `"https://api.x.ai/v1"`       | The base URL for the xAI API                                         |

`xAI` also supports the params of [OpenAI](/reference/models/openai).
